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IMPORTANT ! 


DUPLICATE 
THIS 
DISKETTE 
EEFORE 
USING 
THIS 
FROGRAM! 


I 


This APX diskette is unnotched to protect the software against 
accidental erasure. However, this protection also prevents a program 
from storing information on the diskette, The program you’ve 
purchased involves storing information. Therefore, before you can use 
the program, you must duplicate the contents of the diskette onto a 
notched diskette that doesn’t have a write-protect tab covering the 
notch. 


To duplicate the diskette, call the Disk Operating System (DOS) menu 
and select option J, Duplicate Disk. You can use this option with a 
Single disk drive by manually swapping source (the APX diskette) and 
destination (a notched diskette) until the duplication process is 
complete. You can also use this option with multiple disk drive 
systems by inserting source and destination diskettes in two separate 
drives and letting the duplication process proceed automatically. 
(Note, This option copies sector by sector. Therefore, when the 
duplication is complete, any files previously stored on the 

destination diskette will have been destroyed.) 
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INTRODUCTION 


OVERVIEW 


INSTEDIT is a character set editor that simultaneously displays the character you’re 
editing in all six character modes (the three supported by ATARI BASIC and the other 
three supported only by the hardware). As you use a joystick controller to edit the 
character in an eight-by-eight grid, you see immediately how each change affects the 
character in every mode. When you want to experiment with combining characters, merging 
them to create larger objects, you can use INSTEDIT’s memo pad mode, which lets you work 
in the lower half of the screen in any of the six character modes. It can even help you 
create objects for use with the ATARI Computer’s system of player missile graphics. 


In addition to point-by-point character editing, INSTEDIT’s menu options let you change 
the whole character at once. You may change it to appear as it does in the ROM character 
set; erase it, restore its original shape, invert the colors of the letter and 

background, copy the form of another letter, create a mirror image, rotate it ninety 

degrees at a time, and shift its position within the matrix. Other options let yOu Save a 
character set for further work later and load in a stored character set. Once you’ve 

finished editing a set, INSTEDIT will store all or part of your character data to 

diskette or cassette in the form of BASIC DATA statements, or assembler source code using 
the .BYTE directive, or even an entire BASIC subroutine for incorporating your new 
character set into an existing program. 


REQUIRED ACCESSORIES 


Cassette version 


14K RAM 
ATARI 410 Program Recorder 


Diskette version 


“4K RAM 
ATARI 310 Disk Drive 


ATARI BASIC Language Cartridge 
One ATARI Joystick Controller 


CONTACTING THE AUTHOR 


Users wishing to contact the author about INSTEDIT may write to him at! 


14400 Elm Street 
Osk Park, Michigan 48237 


GETTING STARTED 


LOADING INSTEDIT INTO COMPUTER MEMORY 


1, Plug your joystick controller into the first (the leftmost) controller jack at the 
front of your computer console. 


4. Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your 
computer, 


Lf you have the cassette version of INSTEDIT! 
(Note. If your system has only 146K of RAM and you have an ATART S50 Interface 
Module, make sure the interface module is turned off, You may turn it on after step 
b.) 


a. Turn on your TV set, 


b. Turn on your computer and connect your program recorder to the computer and to a 
wall outlet, 


c. Slide the INSTEDIT cassette into the program recorder’s cassette holder and press 
REWIND on the recorder until the tape rewinds completely. Then press PLAY, 


d. Type CLOAD on your computer and then press the RETURN key two times. The tape 
will load into computer memory. 


&, After the tape finishes loading, the word READY will display on your TV screen. 
Type RUN and press the RETURN key, 


If you have the diskette version of INSTEDIT:! 


a. Turn on your disk drive, 


b, When the BUSY light goes out, open the disk drive door and insert the INSTEDIT 
diskette with the label in the lower right-hand corner nearest to yous 


c. Turn on your computer and your TV set, type RUN "DIINSTEDIT", and press the 
RETURN key. If you’re using more than one disk drive, remember to follow the device 

- initial (D) with the number of the drive containing the INSTEDIT diskette (e.g., RUN 
"DZsINSTEDIT" for disk drive two). 


4, After a few seconds of setup time, INSTEDIT’s five-part screen, described in the next 
section, will display. 


USING INSTEDIT 


INTRODUCTION 
Why create custom character sets? 


Creating custom character sets can serve a number of purposes. For example, you might 
want a custom character set for your computer programs for the same reason you’d want a 
changeable typehead on a typewriter! you may need special math symbols, chemistry 
symbols, foreign language alphabets, or a special typeface to set the mood for a 
particular program. 


On a more sophisticated level, you may want to develop special graphics characters as a 
substitute for the plot-and-draw method for producing high-resolution graphics. By 
positioning several characters together, you can create a high-res picture as Gasily as 
you can print a character string. You can achieve the same resolution with custom mode 0 
characters as you can with mode 3 drawing, The difference is that by using specially 
designed characters, you avoid the high memory usage required for mode $, as well as the 
tedious and slow plotting of each point and line. You can put the finished drawing on the 
screen much more quickly, achieving smooth animation in BASIC just by printing strings of 
characters in succession, each representing a figure in a different position. 


Using machine-language subroutines, you can extend your work into developing 
professional-quality, fast-action arcade games with full color, high-res animation. Using 
custom character sets in this way introduces a new level of graphics power and 
flexibility. If you’re familiar with the ATARI computer’s player missile graphics system, 
you can even use INSTEDIT to design players. 


How INSTEDIT works 


When you press a key on your ATARI computer’s keyboard, one of 128 different characters 
appears on your TV screen. The shape of each character is determined by a collection of 
data stored in computer memory. INSTEDIT lets you change this data, and thus the shape of 
the characters, as easily as drawing a picture. 


The procedure is as follows. You use the computer’s keyboard to select the character you 
want to edit. A large-scale model of this character then displays in an eig ht-by-eight 
grid. Using a joystick, you move a cursor to any of the 64 squares and modify the 
character’s shape. You modify by pressing the red trigger button to add or remove color 
(if color is already present, pressing the button erases it} if color is absent, pressing 
the button adds color). As you change the model character, these changes appear in the 
samples of the character, which are displayed in each character mode. Additional editing 
features let you experiment further with your characters. You can save your finished set 
on diskette or cassette for future editing, or you can incorporate it into a BASIC or 
assembly language program. 


INSTEDIT’S MENU 


INSTEDIT’s display screen is divided into five areas, It looks roughly as follows! 
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Figure 1 INSTEDIT’s Display Screen 


(1) Submenu of advanced editing features, usable with the main menu’s EDIT option. 


(2) Frame for the &-x-§ character grid. Initially, this frame contains the program 
title, Prompts also display in this area. 


(3) Main menu of program options. Underneath the options are three sample rows of the 
model character (7) in mode 0, in both normal and inverse video. 


(4) Mode 0 display of the entire character set (in Internal Character Set order). 
(3) The model character (7) displayed in the other five character modes, in this order! 


(1) Instruction Register (IR) Mode = 
(2) IR Mode 4 


(3) IR Mode 6 (BASIC GR. Mode 1) 
(4) IR Mode 5 
(5) IR Mode 7 (BASIC GR. Mode 2) 


IR Modes 3, 4, and 5 are character modes supported by the hardware, but not by ATARI 


BASIC. The appendix discusses these hardware modes, sometimes referred to in ATART 
manuals as ANTIC modes, 


MENU SELECTIONS 


You select a menu function by pressing the key matching the first letter of the function. 
The functions are as follows. . 


E EDIT 


When you press the letter "E", the prompt, NHICH CHARACTER TO EDIT?, displays in the 
center frame. Type in your desired character, using the LOWR or CTRL key, as 
appropriate, to edit a lowercase or control character. If your desired character is 

an editing symbol, such as one of the arrows, you don’t need to press the ESC key 

before pressing the combination of keys used to carry out the edit function. 


After you select a character to edit, your choice displays at the top of the main 
menu and in each of the screen locations initially occupied by the question mark. In 


addition, a large-scale model displays in the center frame, along with a yellow 
cursor, 


Use your joystick to move the cursor within the frame to edit the character. Press 
the red trigger button to change the square--to color an empty square, or erase a 
colored square. Each of the sample characters reflects your changes as soon as they 
occur; however, the menu and prompt lettering remain.in the standard character set, 


While in EDIT mode, you can also use the submenu options of ATARI, BLANK, COPY, 
INVERT, MIRROR, RESTORE, and TWIST, explained below. After you finish editing a 


character, you can go to another by pressing the "E" again, or you can select the 
SAVE, LOAD, or WRITE function. 


The Submenu functions are as follows. Select a function by pressing the matching 
letter. 


A ATARI 
Restores the character being edited to its normal (ROM set) appearance. 
B BLANK 


Clears the whole character currently being edited, giving you a clean 
background on which to design a new character, 


C COPY 


Replaces the character currently being edited with any other character. After 
pressing "C", the prompt, WHICH CHARACTER TO COPY?, displays in the center 
frame. Type in your desired character. The current character then becomes a 
duplicate of that character, 


I INVERT 


Reverses the colors of the current pattern. All colored squares change to 
background and vice versa. 


M MIRROR 


Changes the character to the mirror image of its present shape. If the 
character is symmetrical, no change is apparent. 


R RESTORE 


Restores the original character as it appeared the last time you pressed "E" 
for EDIT, Any intermediate changes are lost, 


T TWIST 


Rotates the entire character on its axis ninety degrees clockwise each time you 
press "T", 


+f) SHIFT 


Depending on which arrow key you press, shifts the whole character up a line, 
down a line, one square to the left, or one square to the right. You can repeat 
the function by holding down an arrow key, 


S SAVE 


Use this function to store the complete current character set as a data file on 
diskette or cassette. You can then continue editing the set later, or you can 
incorporate it into another program. 


When you press "S", the prompt either asks you to name the data file or to position 

the cassette, depending on whether your disk drive is connected. Diskette users 

enter a file name and press the RETURN key. Don’t include an extender} the program 
avomatically adds the extender ".SET" to your file name, to identify it asa 

character set data file. Cassette users position the tape, press the PLAY and RECORD 
buttons on their program recorder, and press the RETURN key on the computer keyboard. 


When the program finishes storing the character set to diskette or cassette, the 
message SAVE COMPLETE displays in the center frame. If an error occurs so that the 
program can’t complete saving your character set, the original prompt redisplays in 
the center frame. Try another diskette} the one you’re using might contain no free 


sectors, be damaged, or contain a write-protected file of the same name as the one 


you’re trying to save. 


To cancel a SAVE, diskette users should press the RETURN key instead of entering a 
file name, and cassette users should press the ESC key instead of the RETURN key. In 
each case, the message CANCEL SAVE displays in the center frame. 


Although editing character sets might look like drawing, what is really occurring is 
plain old data manipulation. As is true any time you work with data, saving your 
revisions every so often is good practice. This protects you from calamities such as 
your cat pulling out the cord from the wall outlet, thereby wiping out an 


afternoon’s worth of work. How often you save you work depends on how much of it 
you’re willing to lose! 


L LOAD 


Use this function to load a previously saved set from diskette or cassette, If you 
have a disk drive connected, the program asks you to enter the name of the file to 

be loaded and then press the RETURN key. Enter only the name you saved} the program 
automatically appends the extender ",SET" to your file name. To recall the name of a 
file, enter an asterisk (#)--the first ten data files in the directory will display 

at the top of the Submenu area. Display additional file names by pressing the 

asterisk again. Cassette users are asked to position the correct tape, press the 


PLAY button on the program recorder, and press the RETURN key on the computer 
keyboard, 


The message LOAD COMPLETE displays after a successful load. The original prompt 
redisplays after an unsuccessful load. In the latter case, check that your diskette 
or cassette containing the desired saved sets are correctly positioned. Diskette 
users should avoid using any of the I/O commands (Save, Load, or Write) without 
first making sure their diskette is inserted and the disk drive door is closed. 
Otherwise, the drive will keep trying to carry out the program’s instructions until 

a timeout occurs. This activity could continue for a couple of minutes, during which 
time you might think the program has crashed. If one of these situations occurs, 
just be patient until the timeout occurs and then correct the problem and continue. 


Diskette users can cancel this function by pressing the RETURN key without first 


entering a file name, Cassette users can do so by pressing the ESC key instead of 
the RETURN key, 


W WRITE 


Use this function to store a file on diskette or cassette in such a form that you 
can incorporate it into an existing program. To provide flexible alternatives for 
fullest use of your newly defined characters, INSTEDIT can write your character set 
data in any of three formats. This function is one of INSTEDIT’s more powerful 


features, and you should read this section carefully to understand how to use the 
WRITE function. 


When you press "W", a submenu displays the three WRITE options (1) BASIC, (2) DATA, 
and (3) .BYTE. Explanations of these options follow, 


(1) BASIC 


Use this option to write an entire BASIC subroutine to cassette or diskette that 
integrates your new character set into an existing program. In the INSTEDIT program, 
the character data is stored as a string. When this string is defined by the program 
statements of the subroutine, loading the character set from an external storage 
device isn’t necessary. The program loads and runs with your new set. This method 
uses a relatively large amount of memory, but it’s the only way known by the author 
for instantly installing a whole new character set in a cassette-based program. 


The subroutine this option writes in LIST format defines and installs your new set, 
It uses program lines 0 and 30000-31300; therefore, your program can’t contain these 
line numbers, It also uses the variable names QQ$ to contain the string data and 
BASE to hold the location of the new character set in memory} thus, make sure your 
program doesn’t use these names. You can merge the subroutine, in LIST format, with 
a program already in memory by using the ENTER command, 


When you select this option, a prompt tells you to press the RETURN key when you’re 
ready. Diskette users now insert the diskette to be used} cassette users position 

the tape and press the PLAY and RECORD buttons on their program recorder. All users 
then press the RETURN key on their computer keyboard. 


The program then writes the subroutine to diskette or cassette, It might take a 
minute or so to write the routine (consider how long it would take you to type in 

all that data!), The message WRITE DONE displays after a completed operation. The 
original prompt redisplays after an incomplete attempt. In the latter case, check 
your cassette or diskette to make sure everything is set up correctly and try again. 


To cancel the option, press the ESC key instead of the RETURN key after the initial 
prompt. 


To merge the program with one previously saved, first load the saved program into 
computer memory. Next, cassette users type ENTER "C3", position the tape containing 
the LISTed subroutine, press the PLAY button on the program recorder and the RETURN 
key on the computer keyboard, Diskette users type ENTER "D‘LOADSET.LST" (which is 
the filespec the WRITE subroutine assigns to the LIST file), and press the RETURN 
key. The character set subroutine then merges with the program in memory. 


One final step is absolutely necessary. To order the variable table, which has to 
be done to make the combined program work, you must then! 


(1) LIST the combined program to diskette or cassette by typing LIST "Ci" or 
LIST "Difilespec”, as appropriate. 


(Z) Type NEW after the LIST is complete. 


(3) Enter the program into computer memory by typing ENTER"C!" or ENTER 
"Dsfilespec", as appropriate. 


You’re now ready to SAVE or CSAVE and RUN your combined program. 


A final word of caution. The pointer at memory lecation 754 (decimal), which tells 
the computer where the character set is stored, is reset to the default value of 7274 


after every GRAPHICS command. To retain the use of your new character set, this 
pointer must contain the location of your set. As stated earlier, that location is 
stored in the variable BASE. Therefore, after every GRAPHICS command, insert the 
statement POKE 724,BASE to keep your new set in use. You may switch back to the 
ATARI computer's character set at any time in your program by inserting the 
statement POKE 754,224, 


(2) DATA 


Use this option to save any character or group of characters to diskette or cassette in 

the form of numbered BASIC DATA statements. This option is useful in cases where you have 
only a couple of characters to be altered and don’t want to use the memory-intensive 
subroutine produced by the BASIC option. It’s also suitable for occasions when you want 

to distribute printed listings of your program. Because the BASIC option stores the 
character data as ATASCIT characters rather than as numbers, it’s very difficult to 

produce readable listings of programs using that subroutine. The DATA option is also 

ideal for using the characters created with INSTEDIT for player missile graphics. Because 
both players and text characters are eight bits wide, character data can be POKEd into 


player memory without alteration, and it will produce a player the same shape as the 
character. 


After selecting the DATA option, a prompt displays for entering the name of your data 
file, if a disk drive is connected, under which the program will save your character set 
data. The program automatically adds the extender .DAT to your file name so that you’ll 
recognize it as a DATA statement file. Type in your desired file name and press the 
RETURN key. 


Next, the program prompts all users to enter the starting line number for the statements 
and then the increment between line numbers. If, for example, you enter 1000 as your 


starting line number and 10 as your increment value, the resulting file will contain 
statements in the form: 


1000 DATA 0,0,0,44-. 
1010 DATA 159,46,57,...- 


The program then asks users to press the key of the first letter to be saved to the file 
and the number of consecutive letters appearing directly after that letter that are to be 
written to the file. Consecutive letters mean the order of the Internal Character Set 
(corresponding to the order of the complete character set in the middle area of the 
INSTEDIT display), not ATASCII order, A listing of consecutive order is on page 55 of 
your ATARI BASIC Reference Manual. Hence, if you want to write a file with data for the 
letters A through Z, you first press "A" and then "26" to specify the number of 
characters to be saved. To write a file containing the whole set, you first press the 
SPACE BAR (which is the first character in the Internal Character Set), and then type 128 
for the number of characters, 


After you enter this information, the prompt HIT RETURN WHEN READY displays. You can now 
insert the proper diskette or cassette. When you press the RETURN key, the program will 
write the selected characters to the file in LIST format. The message WRITE DONE displays 


after the program completes the write activity. The HIT RETURN WHEN READY prompt 
redisplays if the program can’t complete the activity, 


-9- 


You can cancel the option by pressing the ESC key instead of the RETURN key, 


The program stores character data in groups of 24 bytes (three characters) per program 
line. You can merge the completed data file with another BASIC file by loading the latter 
and then using the ENTER command. 


(3) BYTE 


Use this option to produce data files suitable for immediate integration into assembly 
language source code. The option is similar to the DATA option. Instead of writing the 
data file in the form of numbered BASIC DATA statements, this option, however, produces 
numbered lines beginning with the .BYTE directive and followed by the data in hexidecimal 
form. The output produced takes this form? 


1000 .EYTE $00, $49, $2F, $FC, $468, $0E, $BE, $C7 


You can enter the data file directly to the Editor using the Command ENTER #C! or ENTER 
#Difilespec, as appropriate. Diskette files produced by this option have the extender 
‘BYT . The .BYTE option writes only one character’s (eight bytes) worth of data per line. 


MEMO PAD MODE--OPTION key 


Press the OPTION key to enter and exit Memo Pad mode. This mode, like the ATARI memo pad, 
lets you print any combination of characters just to see how they look. INSTEDIT, 

however, doesn’t limit you to graphics mode 0. You can choose any of the six character 

modes in which to print combinations of characters, 


After pressing the OPTION key, a prompt tells you to type a number between 0 and 7, Type 
in 0, 1, or 2 to set up the bottom half of the screen in the BASIC graphics mode of the 
corresponding number. Type in 3, 4, or 5 to set the Memo Pad to the corresponding IR 
mode. Type 4 to use the Memo Pad but not clear the bottom of the screen, which usually 
occurs when you choose a new mode. This last choice lets you go back and forth from EDIT 
mode to Memo Pad without changing the contents of the Memo Pad. Type a7 to restore the 
lower screen to its initial configuration. 


After you choose a mode for the memo pad, the program sets the lower half of the screen 
to that mode. The cursor, which is visible only in BASIC mode 0 and IR mode 3, is 
positioned in the upper right-hand corner of the pad. You can then print characters and 
set up various combinations of edited characters to see their interconnection. You can 
use a group of characters to form one large picture, or you can use several characters 
stacked vertically to create a tall player. 


To return to EDIT mode, press the OPTION key again. The lower half of the screen remains 
the same while you edit characters, until you press the OPTION key again. Once you press 
OPTION, you clear the lower screen by choosing a mode, or you exit by pressing the "7", 
which reinitializes the screen, 
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are"Fi POCA TT LT oN NOTES 


{i> INSTEDIT allows you to view edited characters 
as they appear in IR modes 2,4, and 3. Althcugh a complete 
treatment of the Display List 15 way beyond the scope of 
this manual. a couple of short BASIC routines ars included 
Helow which will set up a full screen of each of the IR 
modes. These will allow you to experiment with these 
modes, and to use the Script set included with =INSTEDIT, 
which requires the use of IR Mode =3&. For further 
information on these modes, consult the Appendix, and the 
Selected Bibliography . 


Im each case, start with: 
10 GRAPHICS O: DL=PEEFK (340)+254*PEEK S6i 
For IR Mode 3: 


20 PCEKE DL+3,47:FOR I=6 TO 23: PORE DL+1,2: NEXT I: 
PORE DL+24, PEER (S60): POKE DL+25, PEEK(S461): POKE DL+24, 


= 
‘ed ome? 


For IR Mode 4: 


2O PORE DL+3, 68: FOR I=4 TO 28: PORE DL+I, 4:NEXT I 


20 PORE DL+3. 49: FOR f=6 TO i6: POEE D 
PORE DL+17, PEEK(CES0): POKE DL+193, PEE 


(2) Although the Option 1 Write routine is very gcod 
for installing your set in a BASIC orogram, it takes up a 
fair amount of memory. For those disk users who need to 
Save memory, or want to switch several sets during a 
Singies proaramn. tT would suqgest that you use the 
imitialization routine provided by the LOADSET.LST file, 
But substitute the Load roautine of INSTEDIT (lines 
2a 70-2510) for the definition lines (S0100-21200). 
Remember to change the filespec in the OPEN statement to 
the name of your set data file. 


(3) OQne way of getting more colors on a Mode © or 


Mode 2 screen 185 b6yv using color artifacts. You will 
notice that if vou put dots only in odd or even columns 
1.8... without ever putting two dots side-by-side?, amin 
Wiii generate a couple of new colors. While it is 
recommenced that you avoid tnis for text characters, i 
might be useful for gragphics characters. 

(4) One aromising apolication that seems to be a 
matural would ce to de@sian 4a series oT characters 


Gdecicting the face cards at a deck cf playing cards. 
Although TI naven*t nad the time to try my hand, I would he 
interested in hearing from anyone who designs such a set. 


(3) Using the data generated oy Write Option 2, it #15 
fairly easy to plot cut Meade Oo characters oan a SGraphics 
Mode @ screen. so that text and map-plot graphics can 
appear on the same horizontal line. AS an example, use 
Potion 2 to generate a file with DATA statements for 254 
letters. Type NEW, ENTER the data, then type in the 
following program: 


10 GRAPHICS 8: DM=PEEK (S60) +256 (PEEK (561)+4: 
DM=PEEEK (DOM) + 256PEEK (DM+1): OFF=14680 | 


20 FOR I=1 TO 25: FOR J=0 TO 7: READ As POKE DM +0FF 
+3440 +1,8: NEXT J: NEXT I 


=0 GOTO 30 


By varying the offset constant (OFF), you can 
position these characters around the screen. 


€&) AS mentioned in the Menu section, the data 
generated by Write Option 2 or 3 can be used directliv to 
define Players for Player-Missile Graphics. This data <can 
he POKEd directly into the area reserved for FPlayer data. 
Just remember that data from more than one character will 
stack up vertically, one Byte per horizontal line. Also, 
to save space and time, remove any 0 data that precedes oar 
follows the actual piayer snape. 


You may want to keep in mind that Player-Missile 
Graphics oaffers three width ostions for each Player. 
Therefore, you may make use of INSTEDIT’S display of the 
double-wide characters of Graphics Modes 1 and <2, as well 
as the large center display twhich itself is 1 
Maximum—-width player) to visualize the appearance oaf the 
Players you desiaqn in varying widths. 
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(i? Normaliy, about the anlv = 


yoe oF problems 
encountered will be related to [nout/Butp 
rm 
—e 


ut. Examples of 
ames, trying to 
xistent files , 


such errors are use of illegal disk file 
write to locked files. trying to read non 


Gr trying to read an improperly—-positioned tape. Instedit 
does mot return an error message wnen a load or save 
fails, But rather returns to the last prompt. This aives 


you an opportunity to check your cassette or disk, make 
Sure everything 15 set up right, and try again, or cancel. 


(2) At most times the user is protected against 
accidental use of the editing keys in a way which would 
interfere with the screen display. However, full aditing 
functions are restored when the user 15 requested to input 
information longer than one character, such as a “*Ffile 
name. During these times, accidental us® of an editing 
function such as the line delete may disrupt the display. 
If this occurs, complete the function in process. Then, 
hit the OFTION key to enter Memo Pad = ~*mode. Select option 
Ff, Exit. This wili restore the screen ta its original 
configuration. 


[3) While the Break key has been disabled, the System 
Reset key still works. If you accidentally hit Reset, you 
can restart the program by typing RUN. If you doa, 
however, all previous character data will be last. In 
order to save your data, before typing RUN type GOTO 2000. 
TRIS will let you enter the Save routine without clearing 
Character data. When the “SAVE COMPLETE” message appears, 
you may hit Reset and RUN the program. 
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in order to understand how INSTEDIT works, a fair 
understanding ef some of the special Nardware features af 
the ATARI computers is necessary. in ete ek INSTEDIT 
Makes use of Player-Missile Graphics, mixed Diplay Lists, 
and character-set indirection . A review of some of the 
literature dealing with these topics will go a long way 
toward aiding an understanding of how the program works. 
References to some of these sources appear in the Selected 
Bibliography at the end of this manual. 


While not a line-by-line analysis of the program, the 
following general description should give you an idea of 
the program’s logic and oarganization. 


The initialization routine starts at the hack of the 
program, at line 20000, Variables are set up for 
constants, the keyboard is opened as a device, and the 
Handler Tabie 18s checked to see if a disk device is 
present (30000-30020). Next, strings are dimensioned. 
The most important of these are CS, which will hold the 
mew character set data, and PMS, PO, Piss, etc., that hold 
the Player Missile Graphics data. Since both r= 
information and character sets must start on a ik 
boundary, FILLS is first dimensioned to a length that is 
sufficient to waste the space between the last string data 
(ADR (DS) and the next highest 1K boundary (300460), 

Sy superimposing the P-M graphics data area and the 
Character seat data area on the memory area reserved “for 
these strings. we can take advantage of the 
machine-lanquage routines in BASIC that move string data 
around sa quickly. In addition, it enables the use 
(0 7 and itl commands, which mave blocks of 255 bytes. 


XT 

These commands are tied to the use of strings, and they 
account for the ability of the program to rapidly transfer 
data using Gniy BASIC routines. 


After the strings are initialized. the ROM character 

set 15 copied ta the area of RAM set aside for Cs (20100), 
using a short machine—-language routine. Tre Break key is 
disabled, the mixed-mede display is created, and the 
imitial screen graphics are drawn (20106 to 21ités). 
Player-Missile Graphics are then used ta crsate the center 
frame (Player 2 and Missiles grouped as Player 4}, the 
large display character (Player 1), the cursor (Piayer Oo), 
and the grid Oackground (Player 2). The priarity register 

LS S2t sG that when the cursor and large cnaracters 

9D. the cursor changes color . Temporary strings are 

to transfer data to Player memory, and PFP-M araphics 


F in 


ar2@ enstled (S1Li70-21i92). After initializina a cousle of 
snort machine-lanquage routines to shift characters and toa 
craw the large center disnpiay. the proaram oroacesds to the 
maim looo at Line 200, 


The main tlson (200-290) checks the keyboard, the 
console switches, th oystick, and the trigger button, 
Bach in turn. First be checked are the Writes (205), 
OPTION @207), Edit (210), Save (215), and Load (220). if 
one of theses has been hit, the program jumos to the 
approoriate subroutine. In the initial nohase, if one of 
these has not been Rit. the program branches to the 
routine that alternates the menu colors (300-240) and then 
iocops to 260, 


if an the Edit mode, the arrow keys are checked. and 
if ome is Ait, the Shift routine contained on the same 
line is executed (235-250). Atari (2359). Blank (255) . 
Invert (260), Mirror (254), Restore (270) and Twist (252) 
are also one-line routines, while Copy (265) branches to a 
two-line subroutine at 4530, very similar to the Edit 
subroutine at 400, 


Next. the stick is checked, and if not used the 
program looos back to 200, If the stick has been used, 
the cursor is moved by using the horizontal ososition 
registers, or moving the string information up as 
appropriate. 


The trigger check occurs at line 230. it the button 
has been pushed, the program branches to the subroutine 
that actually sets and erases the dots (350-390). This 
routine checks the collision register to see if Players 06 
{the cursor) and 1 (the large character) overlac. Next, 
the bit position and byte number of the character are 
Calculated based on the horizontal and vertical positian 
of the cursor. Finally, = 1S raised toa the power 
represented by the bit piace, and either added or 
subtracted from the byte total, depending on the value of 
the coliision register. 


At this point, we should mention the subroutine at 
Line 10, This 18s the reutine that draws the large 
character, and because it is so frequentiy used, it is the 
only subroutine which has been placed in front of the main 
loop. 

The subroutine at 300-S80 sets up the display of the 
model characters, By POKEing them into display data. The 
Memo Pad routine is at 925 to 995. Save and Load routines 
are at 2000 and 25300 respectively, and the Write routines 
finish the subroutine section at 3000-39710. 
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AT ARI: "HIDDEN" CHARACTER MODES 


The reason that Atari computers arse able to offer 
on a large number ct Sraphics medes is that they use a 
re Graphics microprocessor to handle the screen 
disolay. This chip receives instructions on how to 
display data from a simple program contained in RAM. If 
you are using BASIC, the computer writes this program 
eayery time you give a GRAPHICS command. But simce this 
program is in RAM, it is possible for the user to aiter it 
with the POKE command. Several articles have appeared iin 
magazines giving aiunstructions on how to change this 
program, called the Display List. soa that many different 
graphics modes can appear on the screen at the same time. 
A step-by-sten nlan for creating these mixed Display Lists 


yi 
‘We 


appears in Appendix 4&8 of the Atari Hardware Manual 
favallable from Atari Customer Service) “ The key step 
involves changing the DISPLAY instructian. THis 
instruction consists of ai number from 2 ta 15. Fach time 


it appears, it orders the graphics chip toa display one 
line of a particular mode. For example, PODKEIng in a 2 
orders the chip to display one line of Mode 6, a 6 orders 
up ome line of Mode 1. a 7 one line of Mode 2, etc. 
Notice how the numbers 3,4,5, were skipped?’ These are the 
DISPLAY instructions for the "hidden" character modes. 


When I first tried POKFEiIng those DISPLAY instructions 


imta a Mode © Disolay List, i came up with some pretty 
fumnv-lLooking characters that [ really didn’t understend. 
ta order to find out the purnose behind these modes. which 
are mot supported by BASIC, I had tao turn ta the Hardware 
Manual. lt outlines, in fairly technical terms, some 
nardware features which are not explained by the reference 
material supplied with the comouter. 


TG Relp in the explanation of these modes. [ have 
listed two shart orograms. The first of these (Listing 1) 
demonstrates what is referred to in the Hardware Manual as 
instruction Register (IR) Mode 3. In Line 19, I PFPOFRFE a =i 
into Bytes 19-26 of the Display List, oproducing a screen 
wnich 185 1/2 BASIC Graphics Mode Oo and i/f2 IR Mode 3S. 
Next, the whole character set is printed in both modes 
{Line 20). Finally, a few adjacent characters ar2 orinted 
in both modes for the purpose of comparison (Lines 40-45). 


When this program is run, the IR Mode = characters at 
Ene SsSottom of the screen do not appear ta be much 
cdirferent than the mode 0 characters at the tar. On more 
Tareful examination, mowever , some differences can pe 
Cetected. Pirst, there is more room between the rows af 
cnaracters in ifn Mode 3. HLS 15 seen iin the fact thrat 
WoLia the four diagenal granpnics characters in tne middle 
Sf the screen ferm a diamond shane in Mode oO. tnere is a 


Zan Setween the top and bottom triangles in IR Made <2. 
Also. the cursor 18s talier in that mode. The second 
difference accurs aniy in the last 32 characters of the IF 
Mode 3 set. These characters aprear to be shifted, sa 
that the ton part of the character has been cut off and 
maved nelow the bottom of the character. 


According to the Hardware Manual, there is a simple 
reason tor these differences. By creating a longer block 
for tnese character, and having some appear at the top of 
the Block. and some at the beattom, the user can create a 
custom character set with true descenders for lower case 
letters like "vy" and "p". In order to explain exactly how 
this mode accommodates these changes, however, we must 
first review the method by which the computer determines 


the shape of a character. 


When the computer wants to display screen data as a 
granhics character, 1t must look up the shape of the 


cnaracter in a table stored in memory. To find this 
table, it looks up its location in a pointer held in 
memory location 7/736 =(‘decimal>. Normally. this pointer 


holds the number 224, because the ROM character data is 
stored starting at page 224 j(¢(this is equal to memory 
location 37244, decimal). If you are using a custom 
Character set. such as those created with INSTEDIT, the 
pointer will hold the beginning location of that set of 
data in RAM. Each character is represented by 8 bytes of 
data. As each of these bytes is composed of 383 binary 
diaits (or bits), we can picture this data in the form  ~of 


i 


an Ox& grid. Figure i shoaws how the data for the upper 


and lower case ietter “"L" ais interpreted into the 
character seen oan screen. In this drawing. each 
horizontal row represents one byte (the numeric value of 
which 1S given on the left). Each vertical column 
renoreseants a bit olace. A darkened square represents a 
"i" state ain the corresponding 51it lacation tne bit 
VYaiues, wnich equal the successive powers of 2 from 2 toa 
the O ¢€2) to 2 to the 7th (129) are shown at the toon of 


each column). So, for example, no squares are darkened in 
the top row of Figure ita), and therefore the first byte 
has a value of OO. In the second through sixth rows. where 
bits S and 6 are darkened, the byte value is 746 (64+3%2). 


in IR Mode 3, however, these same characters are set 


up im ai iOx3 grid. Two blank scan lines are inserted 
below each of the first 96 characters (see Figure 2ia)). 
The last 22 cnaracters, which include the lower-case 
alohabst, receive special handling. wren one sof these 
characters is set up in the grid. the first two bytes are 
snitftted down to the bottom two lines {see Figure Z2{b)}. 


TRLs shirt of the last 22 characters means that they use 


che Sottom 3 tines of the grid, while the other characters 
use tne too 8 lines. thus enabling the use af the bottom 
two lines for descenders. S practical example of the. use 
of this mode can 56528 seen in the Seript set which is 


= 
a ar 


tmciucdead with INSTEBIT. You will mote that while tre mode 
accommocates the characters with descenders very well, the 
tall cnearacters such as the lower-case "b" and "d" must be 
transferred to the spot reserved for their respective 
Control-characters, so that they will not be shifted down, 
and can attain their full height. 


The other two nNardware-supportsd character mades are 
demonstrated by the program in Listing 2. tines 10-20 of 
that program set up the screen haif in IR Mode 4, and haif 
in IR Mode =. Line 20 prints the full character set iin 
Bach mode. iin@® 40 changes the background color for 
better visibility. The rest of the program enables the 
use of the console switches to change tne color and 
luminescence value of each register. The SELECT button 
determines the register, START changes the color of that 
register, and OPTION the brightness. 


These two modes are 4-color character modes. The 
oniy difference between these two modes is that IR Mode 5 
characters are twice as high as those of IR Mode 4. 
Unlike BASIC modes 1 and 2. these IR Modes can mix colors 
within a particular character. 


Unon looking at the standard character set in these 
two modes, it will be apparent that these modes are not 
really suitable for text characters. Nhen used with 
custom-designed graphics character sets, however, 
four-color graphics with the same resolution as BASIC 
Graphics mode 7 can be created, and placed on the screen 
Zust by FPRINTing a string of characters. 


To enable this colorful display. the comouter divides 
each byte of Character display data into 4 aoroups of 2 
bits each. These groups determine the color af the four 
mixels oer raw. The four oossibie combination produce the 
following colors: 


Neither bit set--displays the background 
color ‘(register 4) 


Right bit set-- displays the color in 
register 0 


Laft bit set--displays the coler in register i1 


Both set--displays the color in register 2 
for normal video,and the color in register =: 
for inverse video characters 
Because two bits are needed to determine the color of 
Bach cixel, the Rorizontai resolution is eut in half. 
Figure 3 shows fow this atfects letters in the axisting 
cnaracter set. You should be able t05 verify this effect 
Sy changing the colar rsqisters in the Gdemenstration 
or ogram by usima the console switches as explained above. 


REM ** LISTING Ii 
REM ** DEMO OF IR MODE 3 
REM Xx by Sheldon Leemon 
REM XX 
REM *x SET UP MIXED-MODE SCREEN 
REM xx 
O ? CHR (125) =: X=PEEK (560) +PEER (551) €2564+19:FOR I1=0 TO 7:POKE Xt+I1I,2 
O NEXT I:POKE X+8,65:POKE %+9,PEEK (560) :POKE X+10, PEEK (361) 
zi REM x 
2o REM * SET UP COMPARISON CHARACTERS 
24 REM *X 
30 GOSUB 60:POSITION 2,17:G0SUB 60 
40 POSITION 10.12:7 CHRS(46) 3s CHRS (7) 
41 POSITION 10,13:7 CHRS (7) sCHRS(5)3" Li"“sCHRS(149) 
45 POSITION 10,14:7 CHRS(46) sCHRS(7);" "sCHRS (160): "L1" 
4&4 POSITION 10,15:%7 CHRS(7):sCHR#(S):POSITION 15,10:7 " " 
30 PORE 7S32,1: POSITION =,7:? CHRS (28) 
oi REM & 
owe GOTO SS 
236 REM & 
60 FOR J=09 TO 127:7 CHR (27) sCHRE (I) s:NEXT T:sRETURN 


hoe O Chol Rr 
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REM #£x LISTING 2 


i REM ** DEMO IF IR MODES 4 AND s 

= REM x* by Sheldon Leemon 

3 REM xx 

S REM *x SET UP MIXED-MODE SCREEN 

& REM xXx 

10 ? CHRS (125) : X=PEEK (540) +PEEK (361) *256+23:POKE X,. 49 

i= FOR I=2 TO S:POKE X+I1I,S:NEXT I:sFOR I=9 TO ié: FPOKE X+I,4:NEXT I 


29 PORE X+19,65: PORE X+20,PEER (S60) :PORE X+21,PEER (S61) :PORE /7S2,1:7 "%" 
=i REM * 

fo REM * PRINT CHARACTER SETS 

2G REM * 

30 GOSUB 60:7 :?° :GOSUB SO: POSITION 0,0:?° CHRS(iS6) POSITION 1,12 
oi REM & 

co REM * CHANGE BACKGROUND COLOR 

o& REM & 

40 FOR DELAY=1 TO 1500:NEXT DELAY: 7? CHRS (252) :SETCOLOR 4,0,14 

41 REM 

45 REM * COLOR REGISTER CHANGE ROUTINE 

46 REM * 

2O R=O0:5=3:60SU8 7O 

we S=PEER (S35279):IF S=S THEN R=R+1-3% (R=4):60SUB 70 

74 IF S=6 THEN C=C+1-15%* (C=15):SETCOLOR F.C.L:GOS5UB 75 

ao IF S=3 THEN L=L+2-16* (L=14) :SETCOLOR R,C.L:SOQSUB 80 

=f FOR DELAY=1 TO SO:NEXT DELAY: GOTO S2 

650 FOR I=1 TQ 134:°7 CHARS (27) :CHRP (I) s!*NEXT I 

645 FOR I=156 TO 255:7 CHRS (27) :CHRS(T)::NEXT I:RETURN 

7O M=PEEF (79O8+R):C=INTOM/i15):L=M-ié6éx#C 


fl FOQSTTION 2.20:7 “REGISTER "“:R:60SUR 7a:GOSUB SO:RETURN 
fo POSITION 15,25:7 "COLOR ":C3" "“:RETURN 
SO POSITION 25.15:7 "LUM. “sb:" ":RETURN 


Figure 1 


Fiqure 2 


Fiqure 3 


The numbers in the shaded Figures show the color register displayed. 
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The following magazine articles wiil aid the reader 
in understanding tne subjects cof character set editing and 
Player—-Missile Graohics: 


*"Ontopost:Atari-—Missile Graphics Mysteries Revealed", 
George Blank, Creative Computing, January i981, 5.175 

" Character Generation on the Atari", Charles § S&rannon, 
FOMPUTE!, February i981, 95.76 

" Player-Missile Graphics with the Atari POS", Crawford, 
COMPUTE!', January 1981, pop. 646-77 

" An Introduction to Atari Graphics", Crawford and Winner, 
BYTE, January i981, pp.18-32 

" Designing Your Own Atari Character Sets", sary Patchett, 
COMPUTE!, March 19781, p.72 


Resides the articles mentioned above. readers who 
have some technical background will want toa cansult the 
Stari Personal Computer System Hardware Manual, which 1s 


avallabie from Atari Customer Service. This manual give 
complete details concerning hardware features. 
Anoendices A and &, winich deal with Player—-Missile 


Graphics and mixing Graphics Modes, will be of particular 


2nterest. 
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Sonta Clora, CA 95055 


Review Form 


We're interested in your experiences with APX programs instructions are meeting your needs. You are our best 
and documentation. both favorabie and unfavorabie. source for suggesting improvements! Please help us by 
Many of our authors are eager to improve their programs taking a moment to fill in this review sheet. Foid the sheet 
it they know what you want. And. of course. we want to in thirds and seal it'so that the address on the bottom of 
know about any bugs that slipped by us. so that the the back becomes the envelope front. Thank you for 
author can fix them. We also want to know whether our helping us! 


1. Name and APX number of program. 


ame nn 

err 
2. If you have problems using the program, please describe them here. 

eee ee nn nnn 

rere SS 

nee en en 
3. What do you especially like about this program? 

eer Sn 

mre nS nn 

er er rn 
4. What do you think the program's weaknesses are? 

errr een SS 

EE sacs ssc ccs, 

nee Ut nn 
5. klow can the catalog description be more accurate or comprenensive? 

er 

rn nn 
5. Onascaleot1to 10. 1 being “poor” and 10 being “excellent”. piease rate the following aspects of this program: 

Easy to use 

User-oriented (e.g.. menus. prompts. clear language) 

Enjoyable 

Self-instructive 


Useful (non-game programs) 
Imaginative graphics and sound ~ 


7. Describe any technical errors you found in the user instructions (please give page numbers). 


8. What did you especially like about the user instructions? 


9. What revisions or additions would improve these instructions? 


10. On a scale of 1 to 10, 1 representing “poor” and 10 representing “excellent”, how would you rate the user 
instructions and why? 
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11. Other comments about the program or user instructions: | © 
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ATARI Program Exchange 
PO. Box 3705 
Santa Clara. CA 95055 


'seal nere: 


7. Describe any technical errors you found in the user instructions (please give page numbers). 


8. What did you especially jike about the user instructions? 


9. What revisions or additions would improve these instructions? 


10. On a scale of 1 to 10, 1 representing “poor” and 10 representing “excellent”, how would you rate the user 
instructions and why? 
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11. Other comments about the program or user instructions: . @ 
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ATARI Program Exchange 
P.O. Box 3705 
Santa Clara. CA 95055 


‘seal nere; 


